NetCloak 3.0 User's Guide: Commands: Configuration

	Version 3.0 User's Guide

Commands: NetCloak Configuration	Previous \| Next Contents

<SET_NETCLOAK setting = value> OR
<NETCLOAK setting = value>

The SET_NETCLOAK (or NETCLOAK) command is used to set many of NetCloak's configuration options for a single page, or even for only part of a page. These options, when set using this command, will supercede the default settings that have been defined in NetCloak. However, the revised setting will only be in effect for the page in which the SET_NETCLOAK command is used. Other pages being served will be unaffected by temporary configuration changes made with the SET_NETCLOAK command.

Here are the configuration options that can be set using this command. For each setting, the list of valid values is given.

Translation - This sets the character translation mode for text following the command. Possible values are:

Entities	Convert Mac characters to HTML Entities.
Latin	Convert Mac characters to the ISO-Latin-1 character set.
None	No character conversion.

For example, to have NetCloak perform MacRoman to ISO-Latin-1 character translation, you could use the command:

    <SET_NETCLOAK Translation = Latin>

LastMod - This allows you to change the "Last Modified" field of the HTTP header for the page on which the command appears. Possible values include:

File	Return the file's last modified date in the HTTP header.
Now	Return the current date and time in the last modified field of the HTTP header.
None	Leave the last modified field out of the header entirely.

For example, assume you have a page with numerous sections of random content, but you have set NetCloak to return the file's modification date as the Last-Modified date of the HTTP header, by default. For the page in question, you can override this default by including the command:

    <SET_NETCLOAK LastMod = Now>

This will cause the browser to recognize the fact that the page is constantly changing, and perform caching appropriately.

TimeFormat - This allows you to change the format of time values in the current page. Possible values include:

Short	Use the short time format when displaying time values.
Long	Use the long time format when displaying time values.

DateFormat - This allows you to change the format of date values in the current page. Possible values include:

Short	Use the short date format when displaying date values.
Long	Use the long date format when displaying date values.

Logging - Lets you enable or disable logging of pages on a per-page basis. Possible values include:

Off	Turn hit logging off.
Standard	Enable logging of date, time, status, client IP, script name, reply length.
Extended	Enable logging of standard information plus username, password, referrer, and user-agent.

ServerField - This text value is sent as the value of the "Server:" field in NetCloak's HTTP reply header.

PragmaNoCache - This determines whether or not NetCloak will tell the browser (and any other caching mechanisms in between) to not cache the page.

True	Include a "Pragma: no-cache" field in the HTTP reply header for dynamic pages.
False	Do not include a "Pragma: no-cache" field in the HTTP reply header.

CreatorCode - The four-character creator signature NetCloak uses for created files. The creator code determines the icon of the file, as well as which application launches when the file is double-clicked.

<INSERT_NETCLOAK setting>

INSERT_NETCLOAK inserts the current value of the specified configuration parameter into the page. In addition to the configuration settings listed above, this command also lets you insert the following information into the page:

Version	Inserts the NetCloak version number.
UpSince	Inserts the date/time NetCloak was last launched.
Hits	Inserts the total number of pages processed by NetCloak since it was last started.
CacheHits	Inserts the total number of pages served from cache.
LastHitTime	Inserts the date/time of the last hit.
LastHitType	Inserts the "action" name of the last hit.
LastHitHost	Inserts the hostname of the last hit.
LastHitPath	Inserts the file path of the last hit.

<SHOW_NETCLOAK setting operator value>
<HIDE_NETCLOAK setting operator value>

These commands show or hide the HTML that follow them (until the next SHOW/HIDE command) if the specified configuration parameter satisfies the comparison to the given value. As with other commands, you may specify a list of values to test against. If the comparison operator is omitted, an exact text match is required.

For example:

    <SET_NETCLOAK DateFormat = Long>

This command will cause NetCloak to display all dates inserted by NetCloak commands in the remainder of the page using the Long Date format defined in the server's Date & Time control panel.

    <HIDE><SHOW_NETCLOAK Logging IS "Off">    Logging is currently disabled.
    <FLIPMODE>    Logging is currently enabled.
    <SHOW>

This series of commands will tell the user whether or not their web server access is being logged by NetCloak.

The SHOW and HIDE_NETCLOAK commands are also useful in combination with the SET_NETCLOAK command to make conditional changes to NetCloak configuration settings.


Copyright © 1996-1999 Maxum Development Corporation http://www.maxum.com/	Previous \| Next Contents

Commands: NetCloak Configuration

<SET_NETCLOAK setting = value> OR <NETCLOAK setting = value>

<INSERT_NETCLOAK setting>

<SHOW_NETCLOAK setting operator value> <HIDE_NETCLOAK setting operator value>

<SET_NETCLOAK setting = value> OR
<NETCLOAK setting = value>

<SHOW_NETCLOAK setting operator value>
<HIDE_NETCLOAK setting operator value>